home *** CD-ROM | disk | FTP | other *** search
/ Halting the Hacker - A P…uide to Computer Security / Halting the Hacker - A Practical Guide to Computer Security.iso / rfc / rfc1929.txt < prev    next >
Text File  |  1997-04-01  |  4KB  |  116 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                           M. Leech
  8. Request for Comments: 1929                    Bell-Northern Research Ltd
  9. Category: Standards Track                                     March 1996
  10.  
  11.  
  12.              Username/Password Authentication for SOCKS V5
  13.  
  14. Status of this Memo
  15.  
  16.    This document specifies an Internet standards track protocol for the
  17.    Internet community, and requests discussion and suggestions for
  18.    improvements.  Please refer to the current edition of the "Internet
  19.    Official Protocol Standards" (STD 1) for the standardization state
  20.    and status of this protocol.  Distribution of this memo is unlimited.
  21.  
  22. 1.  Introduction
  23.  
  24.    The protocol specification for SOCKS Version 5 specifies a
  25.    generalized framework for the use of arbitrary authentication
  26.    protocols in the initial socks connection setup. This document
  27.    describes one of those protocols, as it fits into the SOCKS Version 5
  28.    authentication "subnegotiation".
  29.  
  30. Note:
  31.  
  32.    Unless otherwise noted, the decimal numbers appearing in packet-
  33.    format diagrams represent the length of the corresponding field, in
  34.    octets.  Where a given octet must take on a specific value, the
  35.    syntax X'hh' is used to denote the value of the single octet in that
  36.    field. When the word 'Variable' is used, it indicates that the
  37.    corresponding field has a variable length defined either by an
  38.    associated (one or two octet) length field, or by a data type field.
  39.  
  40. 2.  Initial negotiation
  41.  
  42.    Once the SOCKS V5 server has started, and the client has selected the
  43.    Username/Password Authentication protocol, the Username/Password
  44.    subnegotiation begins.  This begins with the client producing a
  45.    Username/Password request:
  46.  
  47.            +----+------+----------+------+----------+
  48.            |VER | ULEN |  UNAME   | PLEN |  PASSWD  |
  49.            +----+------+----------+------+----------+
  50.            | 1  |  1   | 1 to 255 |  1   | 1 to 255 |
  51.            +----+------+----------+------+----------+
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58. Leech                       Standards Track                     [Page 1]
  59.  
  60. RFC 1929          Username Authentication for SOCKS V5        March 1996
  61.  
  62.  
  63.    The VER field contains the current version of the subnegotiation,
  64.    which is X'01'. The ULEN field contains the length of the UNAME field
  65.    that follows. The UNAME field contains the username as known to the
  66.    source operating system. The PLEN field contains the length of the
  67.    PASSWD field that follows. The PASSWD field contains the password
  68.    association with the given UNAME.
  69.  
  70.    The server verifies the supplied UNAME and PASSWD, and sends the
  71.    following response:
  72.  
  73.                         +----+--------+
  74.                         |VER | STATUS |
  75.                         +----+--------+
  76.                         | 1  |   1    |
  77.                         +----+--------+
  78.  
  79.    A STATUS field of X'00' indicates success. If the server returns a
  80.    `failure' (STATUS value other than X'00') status, it MUST close the
  81.    connection.
  82.  
  83. 3.  Security Considerations
  84.  
  85.    This document describes a subnegotiation that provides authentication
  86.    services to the SOCKS protocol. Since the request carries the
  87.    password in cleartext, this subnegotiation is not recommended for
  88.    environments where "sniffing" is possible and practical.
  89.  
  90. 4.  Author's Address
  91.  
  92.    Marcus Leech
  93.    Bell-Northern Research Ltd
  94.    P.O. Box 3511, Station C
  95.    Ottawa, ON
  96.    CANADA K1Y 4H7
  97.  
  98.    Phone: +1 613 763 9145
  99.    EMail: mleech@bnr.ca
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Leech                       Standards Track                     [Page 2]
  115.  
  116.